Markdown 은 글을 쓰기에 좋고, 위키 문법은 페이지를 잇기에 좋습니다. 둘 중 하나만 골라야 하는 것은 아닙니다. AhaWiki 는 위키 문법인 AhaMark 를 기본으로 하고, 페이지 안의 일부를 Markdown 으로 쓸 수 있습니다.
1. 왜 둘이 필요한가
Markdown 의 링크는 주소를 씁니다. 위키의 링크는 이름을 씁니다. 차이는 글이 많아질수록 커집니다.
[설계 문서](https://example.com/w/DesignDoc) Markdown [DesignDoc] AhaMark
이름으로 링크하면 도메인이 바뀌어도 그대로이고, 아직 없는 페이지도 링크할 수 있고, 엔진이 어느 페이지가 어디서 불렸는지 알 수 있습니다. 역링크와 그래프는 여기서 나옵니다.
반대로 다른 도구에서 가져온 글은 이미 Markdown 인 경우가 많습니다. 이것을 모두 고칠 필요는 없습니다.
2. 페이지 안에 Markdown 블록 넣기
Markdown 으로 된 글은 블록으로 감쌉니다.
| Raw | Preview |
|---|---|
[[[#!Markdown Hello, **AhaWiki**! * [AhaWiki](https://ahawiki.net) * `inline code` ]]] |
Hello, AhaWiki!
|
자세한 내용은 InterpreterMarkdown 에 있습니다.
3. 어떻게 나눠 쓸까
- 다른 도구에서 가져온 글, README 사본 — Markdown 블록에 그대로 넣습니다.
- 계속 고쳐 가며 다른 페이지와 이어질 글 — AhaMark 로 씁니다.
- 표, 수식, 다이어그램 — 문법보다 블록을 씁니다. InterpreterTable, InterpreterMath, InterpreterMermaid 같은 블록은 AhaMark 페이지 안에 넣습니다. 목록은 Interpreter 에 있습니다.
4. 함께 쓸 때 주의할 점
- Markdown 블록 안의 내용은 Markdown 으로 해석되므로
[PageName]같은 위키 링크가 되지 않습니다. - 링크를 살리고 싶은 글이라면 Markdown 블록에 넣는 대신 AhaMark 로 옮기는 편이 낫습니다.
5. 문법을 처음 볼 때
- AhaMark Basic — 제목, 목록, 링크 같은 기본 문법
- ExampleMarkdown — Markdown 예제
6. 함께 보기
7. See Also
7.2. Similar Pages
Similar pages by cosine similarity. Words after page name are term frequency.